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August 30, 1978 



Re: New Meua of TRS-&Q Disk 

Operating System, TRSDOS 
Version 2.1 (Replaces 2.0) 

Deer TRS-flO Customer: 

Enclosed Is a TRSDOS Version 2.1 Advance Package containing: 

TRSOOS 2.1 diskette 

TRSOOS 2.1 Fact Sheet 

"More Things You Should Know" Addenda for 

Preliminary TRSOOS Instruction Manual 
Preliminary TRSOOS Instruction Manual 

You should understand that: 

1) Yerslan 2.1 repltCCS 2.Q, It contains corrections Df problems 
present in the older version, plus many new features. AIT this 
info Is detailed in the 2.1 Fact Sheet. 

2) Programs and data created under 2.0 can be used under 2.1. 

3) A new Instruction manual for 2.1 will be released soon and 
distributed to customers through the Radio Shack stares. Until 
it's ready, you should use the Preliminary Instruction Manual 
for TRSDOS 2.0, as updated by the 2.1 Fact Sheet and More Things 
YOU Should Know. 



Thank you 



Computer Merchandising 



THt BIGGEST NAUS IN LITTLE COMPUTERS 



TRSMS 2,1 FACT SHEET 



Some of you may be a little confused about the terminology, "Version 2.1". 
"first release", etc. You'll be bearing these ten* often as TR5D0S is 
updated, so Here's in explanation. 

A new version represents i substantial expansion of the previous version. 
For example, new utilities, higher level language paxl:au«s, etc., might 
be included in a new version. Such versions art numbered 1,2,3, etc. 

On the other hand, a new release 1s simply in update of the previous 
release of a given version. This later release generally includes fixes 
of problems In the esr'ier version, wider laplewitatlons of comsands , 
enhancements of cojirands , etc. The r*le*St» art "ttapUtnd .1, .2, .3, etc. 

Therefor* wrwn we tall about "Version X.V. that's short for Release V of 
Version X. 



MOTE: Uppercase letters. falanks()l) and punctuation are required 
as shown. Lowercase letters Indicate paraneters and options you 
supply from a specified let as given In that command's syntax 
description. See Preliminary Instructions for 2.0 for an explanation 
of filestttfc , drtvespuc, pats sword , etc. 

Corrections, of problem In 2.0 

1. 01tJt file-spice allocation and release (SAVE and KOL) now function! 
correctly. Use of a near-full or full diskette ft okay. 

2. F0W1AT and BACKUP cceaaends have beer fixed so they do not automatically 
re-boot the system upon completion. This gives you * c hance to see ^^ 
If any error ocssages were generated. Pressing HOED *U1 tnan rt-bOOt 
the- systwti- 

3. The DEBUG utility can (and should be) deleted from FAH. when you're 
through usin g it. b y pressing RESET and then entering the commands 

ocsoc-p(off) imm 

OIR PiTtTn 

This coeiHrtd sequence will prevent unexpected re-entry Into the 
DOUG program. HOTt: To exit the OEBUG utility to TOCOS, type 

mm V 

4. The LIST command now positions the cursor properly. 
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Commands Added or Changed in 2.1 
APPENDS i 1 especl »T0»f 1 1 esp*t2 



Appends the Hnt file specified to the end of the second file *P* C J"*|- 
The first file is not changed. This cowmand is primarily for use wl th data 



files 
BXaVjfaltt 



APP2flWTA7»TQpDATAfi 



ATTRID*f11esnecBfartHb.M:CT»swl.UPO-pw2,PW)T-para») 

where: awlfa ■ I (for Invisible). Optional and usually omitted. 
pfol » new access password. Optional. 

ft : S oTtne KflStfg: ^J^E.WRITH.REAO.aEt. Optional. 
This coarond lets you assign bio passwords to «w "lejpeclfied: an access 

password, which will alio- access to the file as determined by the PPQT 

perimeter-, and an update password, which will alow total access .o the 
file. Mote that the protection levels form a hierarchy, and that Gaen 

level implies accass to all lower levels: 

KILL fmpHes total access. 

REMAHE implies access to rename, write, read and execute. 
WRITE ImpUss accass to write, read and execute. 
READ implies, access to read and execute. 
EXEC Implies access to execute only. 

The I (Invisible) attribute 1i optional. It makes the file invisible to 
a normal OIR cosmand (see OIR). 

ft* «*rv careful In assianlnq protection attributes to a file. If you 
ftroet^th^IsUrd! 58 ^ flVcannot be accessed or updated, except via 
the PROT command and Master Password (see PROT below). 
Example^: 

ATTR IB»PRD^il/BAS . PSW»(ACC-PSM1 ,UPU-PSW2,PF10T=READ) 
assigns new passwords to PP.0G1. 

ATTOBftPROGl/BAS. PSW2p(ACO ,UPD« ) 
removes the passwords from PR0G1 . 
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DCVICE 



This coenwnd has no arguments or parameters. It simply lists all currently 
defined I/O devices: RI (keyboard) , DO (Video Display). and PR (Line Printer). 



OTO: dB(paraal .paraa* ,pan«S) 

Where- Id 1s fln optional drive specification (d-0,1,2 or 3) »ndpar*m\. gnrawZ. 
parooi3T re optional parameters, including any, all or none of the following: 

S Display all System and nan- Invisible files. 
1 Display *11 Invisible and non-Systcra files. 
A Give tb* disk space allocation for all Ml" displayed. 

Disk space allocation Is Indicated fli follows: LRL (logical Record Length). 
EOF (End Of File), and GPA'IS (number of Granules used; each granule-S track, 
or 1.2BK). 

Eaaaplas: 



displays user files (non-5y*te*n, non-Inv1sibleJ on drive 0. 

DW.-lfcU.S.A) 

displays all files on drive 1, Including, each file's disk space ?llocat1on. 

HJTE: Din lists e P beside all user files with non-blank passwords. 

If the Directory listing cannot fit on the ween, only the first 12 lines 
will be displayed- Press (E.H1LRI to see the next 16 lines of the listing. 



BWP)^f^^esp«cp(^/RM , AM\^ERD■*I t raBB^TRA'X'CXCX , ) 

where AAAA, BOHB. CXCC are hexideclmil addresses 1n HAM, and AAAA, BBflB 
are above 6fTTT~ 

This ccmnd writes the contents of ■wmry fro» the specified start address 
to the end address, -and specifies a transfer address where execution of the 
program Is to begin after the file is called for execution. The main purpose 
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of DUMP is to let you create disk files containing machine code programs 

(created with TBUG. Editor/Assembler, BASIC POKis, etc., or loaded fro* 
tape under SYSTEM command). 

Hast LEVEL II System tap*»s cannot be executed under DOS, because of 
differences between UVEL II and DOS in tertns of RAM use. See More Thingi 
You Should Know, I ten 6. 



TMs function rcir-r** no arsuaaents or parameter*. It displays the amount 

of fr*e space rat1n1.no, on all currently ln-us* drives, in terra of files 

available ar-d unused granules. 

Each diskette c*r. sup-pert up to 48 user flics. 



L» 

Requires no parameters or argumflnts. Lin displays all TttSDOS system concmnds 
available. 



LOAD H1csf=c 

Loads the specified file (which should contain Z-80 ohject code] Into RAM 
and returns control to TRSU05. The sneclfled file would normally have been 
cre?t?d by A DUMP or TAPCP I SK command. 



WCT»:d&(PW.param) 

where jd_ is an optional drive spec, PW U an optional explicit parameter, 
and par an Is an optional parameter, e .OCR or UNLOCK. 

This co-Ttnand changes the protection status of all non-System files on the 
specified drive. Drive 1$ the default drive If none is specified. 
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To use MOT, you Jwst k/xm the diskette's MfUrr Ptsword, assigned dyririf 
FQfttAT or BACKUP of the dlikett*. (Tour 7R5O0S dfskttte has the password. 

mssum.) 



To Change the fester Password, specify PH. To remove passwords froa all user 

flit*, tptclfy UfilOCiC. To u>Kf the Haster password on all user flits, 
specify LOCK. 



ties: 

rWTIrbWHJBK] 

After you enter this eomnd, TS5D0S asks for the Hester P«$*ord. If you 
enter the right word, ell passwords will be removed fro* user Hies on the 
drive 1 diskette. 

PROT (PV.LOCK) 

After you specify the Hester Password correctly. TASDCS will prompt you to 
enter * new Master Password. Then this new password .111 be assigned to the 
drive dltkPtu and to til 1U tsar files. 



HWAMElf 1 1 espec l»T0»f 1 1 eip«c2 



Allows you to eh&noe the nam (ami/or extension} of the first fit* specified 
as dtserlbtd In the second fllespeclficatlan. Tog cannot cftamjt or add 
passwords with RBtfME. The file's protection status also remfns oflc he npa d . 



VEHIFY»(pari«) 



where psriB ■ OH or OFT. VERIFY (OK) eausa* T1S00S to wrlfy til user 
dlsk-wHtTboeratlons {for eueple. file-writes fros BASIC) . VERIFY (OFF) 
dlsebles this function. 

VERtFY does not effect Systen disk wrltosi they ere always verified. Also 
wtt that TJG00S POwsm up In a VERIFY SOFT) condition. 



This Is a special utility which allows you to load Radio Shack SYSTEM tapes 
into RAH. and then <fu*« tho ft It fro* RAM Into a specified file on the disk. 
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Do not attempt to read In tape files which load below hexadecimal address 
$4F4. See P.ore Things You Should Know, Item 6. 



TAPED! SK 

Initiates the TAPEDISK program and r*tums with a special prompt 



You then enter one of three ccmnands 



C 1EUTH1 

turns on the Recorder (Recorder #1 If two are connected) and loads a 
SYSTEM-- format tape Into RAM. Mien tho file has loaded, the prompt 
is. You can then load mother SYSTEM tap* Into R/H by typing C 
again, or enter another 



FUf UespecUAAAAbBBBShCCCC ESI 

1s the duatp to disk coanand, where fllespcc Is the desired file name and 

u .- > .-i. i : : . drive macl flat Ion; *AftA is the starting address in w«i 

8||b the ending address; *nrlCf2F~tha entry point for execution of the 
rTTe. All addresses are in hexadecimal form. After the dump, the prompt 
returns* 



E EE 

returns you to TRSOOS. 



Hsmm*t*a 



19 a special utility which allows you to nuke a sector-by-sector examination 
of any iBeciflftd U59T file . DIS KDUWP/PAS is a BASK program, so you must 
be in hrlt BA5?C anfpress tffiEIl for the FILES? and MEMORY SIZE? question.. 

The progra* Is written to dump to the Line Printer; If you do not have one 
connected, change all LPTlIirTs to PRINTS and the dun* will go to the Display. 
In line 160, delete everything after 160 GET 1, Sit. 

The oroaram prompts you to enter the filen ame and then to enter the sector 
you ™t£ examine. You can simply press EEH tit. the sector exarai nation 



will be sequential. sttrt1i«l with sector 1. Hole that if you attempt to 
examine a sector which is higher than the highest sector used by that file. 
no error message 1s given and the sectors will appear as iero-value bytes. 



net sneet/7 



The sectors are pHnted 16 bytes at a times awl these 16 bytes m printed 
first In hex code ami then with the correspondl iifl ASCII code. The ASCII 
representation Is surrounded by I symbols. If the hex code does not 
correspond to an alphameric character, a period 1$ returned for that 
byte In the ASCII representation. 

This program will be wry useful In helping you 
sequential data formats is stored on disk. 



CtOCK (per**) 

when nana It either OK or OFF. If no p»ram»ter Is g1vtm B ON 1s assumed 
This fSnctTon wes In 2.0; homever. the OFF capability has been added. 



TRACE (paran) 

where peraa Is either ON er OFF. If no paremeter Is elven. 0W Is assumed. 
TRACE was In 2.0, but the OFF opaotlity has been added. 



Mors Thlnas You Should Know 



1. Always follow these rules when cocrrwctlng. M*M 01sk drives to the 
TRS-60: 

a) You can use from one to four drives with TRSDOS. However, 
your set of drivts Wt% Include one (and only one) drive with 
Radio Shade CaUtoVTBSber 26-U60. AH other optional drives 
must bear Catalog fttaber 26-U61. 

b) Drive 26-1160 must always be the -terminal* drive" (the furthest 
away from the Expansion Interface), and there rust be no empty 
connector* between the terminal drive and the Expansion Interface. 

c) Al» rmwber that TRSDOS refer? to the drives by the numbers 
0,1,2 and 3, where drive 1s closest to the Expansion trtarface, 
and drive 3 Is furthest from it. 

To copy UAS3C program files from a 2.0 to a 2.1 diskette utlng only 
on- drive (drive Ql, first CSAVE the 2.0 file onto cassette: then 
reboot the systam with a 2.1 diskette, CLOAD the file, and SAVE It 
onto the 2.1 diskette. 

The maximum TAB for an LPRrKT statement is 53. The Line Printer won't 
tab past colunn 63. 



Z. 



There's a simple way around this Hirttatlon, using the STRIWfWCtlon 
to sialyl ate tab* past column 63. The idea Is to print out a "ring of 
blanks to move the print head to the desired position. The STRINGS 
function will produce such a string of blanks. However, it will only 
rove the print head relative to the current print position, so you 
have to do a few calculations to move the print h*ad to l particular column 

In general , 

TAB(n) can be simulated by STRIHG${K-l-current print posUlon.32) 

Jt-1-currsnt print Po si tion locates the desired column in relation to the 
current position; 32 is the ASCII code for blank. 

Exroplo: 

LPRIffT TAB (5)*WWnAB(30)"A0-DRESS"STRI«6fi{63 t tt)*MU«E" 

will print "NAME" at column 5, -ADDRESS" at column 30, and "BALANCE" at 
column 100, 



more things/? 



4. PfclHTIn (write to sequential <£1 sk file) puts Information on the diskette 
in the saw format that a PRIKT (to Display) would put the same Infor- 
mation on the Video Display. It does not use the PRInTi-n (print to 
tape) fonsat. For example, if A«3. 14159,6— 2.3, then 

P*INT*1,A.B 

would pHnt the following In file 1: 

P3.14159WHU1IP-C.9t1 



hat 



PRIHm.A;B 

would print the data without all the extra spaces: 

»3.14159p-2.3ft 

So be sure to use- semicolons as deMmiters wham writing numeric data 
to a disk Hie with PflllTTin. 

5. Using PRIKTsn to write strings to sequential files also requires special 
attention, fcecausie delimiters will not automatically be inserted after 

string data. 

For example, If A$»N0HN SMITH* and 3$-" JILL SMITH-, then 

PRINT#1,AS.ES 

will wrlta the data on disk as follows: 

JOHN SHITHJtLL SMITH 

You will not be able to read the two names Into separate variables with 
an [HPUT#n statement. 

To avoid this, place an explicit coana after every string embedded in 

a PRINT* statement. For example, 

PR]WT#1,A$;\";B5 

will allow you to retrieve A£ and BJ individually with an 

INPUT*! , AS. BS 



thlncs/3 



To writ* strings which Include ceemas and/or carriage returns, put quotes 
•round the string by using CMS (34). For example: 

Eaptrlment with the** techniques, and tnen use the OtSIDURP prooreai to 
exaalne exactly what we* written to the file. 

6. The only currently available Radio Shack STSTW tape that can now be 
loaded under DISK BASIC oe 005 and than pieced on the diskette for 
liter m 1s the REM* progreet, 

Wftt load *MArf **** *° dUh us, "9 TAPE0I5K. Then to use REM*. 
type REhum \ixrJM\ 

K^JS^tiw oeoory size? Question with 3U19. Toe on uh the progren 
In LEVEL II BASIC. 

7. If you are able to define a distinct, repeatabla problea which you are 

not able to lolve. write (town thai exact tfixuaatawcw (e*»cbtne» configuration 
end sequence which caus.es the prob1e«) and the folloerfiwa office will eeke 
•eery effort to find the wlution. This does not include custoner pro- 
arajaelng errors, as we do not have the facilities to do this now. 

TRS-60 rroblens Desk 
1100 One Tandy Center 
Fort Worth, TX 76102 

•nnouncenents of new versions or releases erf 11 autoatttlcany be sent to 
.you, 

ft. The only tiae you should disable the realties dock (with th* OIK BASIC 
COawHaV CMO'T") 1* laseedlatcly Before you instruct the systen to perform 
cassette 1/0. Be sure to re-enable the clock (with the DISK BASIC coeaeand. 
CHTR") inseoMatoly after the cassette I/O opa>rat1on 1i completed. Toe 
could destroy the TRS0OS svsten files by allowing disk 1/0 operations when 
the clock is off. Follow the above precaution* to •Marinate this possibility 



